home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1998 #2 / Amiga Plus CD - 1998 - No. 2.iso / pd / musik / euterpe_installation / euterpe / docs / euterpeeng.doc next >
Text File  |  1997-10-04  |  51KB  |  1,229 lines
  1.                                  Presentation
  2.  
  3.     Welcome in Euterpe help. Select the subject of interest with a click in
  4.     the matching button. 
  5.     
  6.     In  introduction  this is a presentation of the software, its features 
  7.     and a few other informations. 
  8.     
  9.     If you are discovering Euterpe, or if you never used a sequencer before 
  10.     then you need a  tutorial . 
  11.     
  12.     For learning everything about Euterpe's  screens  and learn how to
  13.     control them. 
  14.     
  15.     Most of the actions that you will produce with the sequencer will take 
  16.     place in  windows . You will have there a detailed description. 
  17.     
  18.      Menus  are differents relating to the selected windows. You will find
  19.     there where are the operations that you look for. 
  20.     
  21.     It is told that an expert user never use any more menus but only 
  22.      keyboard shortcuts . You can learn them here. 
  23.     
  24.     You already know how to use Euterpe but you would automatise a few
  25.     functions  ARexx  has been made especially for that. You can define
  26.     macros, save them and also call them from the external interface. 
  27.     
  28.                                      Introduction
  29.  
  30.     This is the documentation of Euterpe 1.12. In this part, are all the
  31.     informations which do not directly concern the software use. 
  32.     
  33.      Features                            
  34.      Registration                        
  35.     
  36.      Translation                         
  37.      History                             
  38.      Thanks                              
  39.      Author                              
  40.      Versions                            
  41.     
  42.                                        Features
  43.  
  44.     Euterpe is a multimedia sequencer
  45.     
  46.     Detailed features are : 
  47.     
  48.     Recognised file formats : 
  49.     
  50.         For songs : MidiFile type 0 and 1, SMUS (read only), and ETSF
  51.     (specific IFF format) 
  52.     
  53.         For the sounds : AIFF, IFF 8SVX and DataTypes 
  54.     
  55.         For the pictures IFF ILBM and DataTypes 
  56.     
  57.     Genlocks Support 
  58.     
  59.     Unlimited tracks (theorically) 
  60.     
  61.     Tracks Types : Instrument for the notes and Samples for the sounds 
  62.     
  63.     Unlimited patterns on tracks 
  64.     
  65.     Patterns types for instruments tracks : Channel, Common and SysEx 
  66.     
  67.     Instruments types : Midi, Midi Drum, Audio, Audio Drum, Texts, Pictures,
  68.     ARexx and XApp 
  69.     
  70.     Recognise formats General MIDI and Roland GS 
  71.     
  72.     Knows most constructors sysex codes and most Control Changes by name. 
  73.     
  74.     Events Editor and Bar Editor 
  75.     
  76.     Sample Editor with Fast Fourier Transformation option for sound frequency 
  77.     calculation 
  78.     
  79.     Midi Test functions (notes, programs and banks) 
  80.     
  81.     Synchronization Midi Time Code, TimeClock and by sampling 
  82.     
  83.     Metronome 
  84.     
  85.     Midi Mixer 
  86.     
  87.     Midi Effects 
  88.     
  89.     ARexx macros definitions 
  90.     
  91.     Multifiles : Up to 10 songs can be used simultaneously 
  92.     
  93.     Display sensitive to fonts and supports all resolution starting with
  94.     640x200, 8 colors 
  95.     
  96.     Midi Access via devices or CAMD.library (optional). 
  97.     
  98.     Audio Access internal or using AHI.device (required) 
  99.     
  100.     ARexxPort 
  101.     
  102.     Public Screen 
  103.     
  104.     Internal resolution from 96 to 768 pulses per quarter note (192 is
  105.     default) 
  106.     
  107.     Supports external controler via Joystick port 
  108.     
  109.     Master Track allowing tempo and signature changes 
  110.     
  111.     Knows latin, english and german writings for notes 
  112.     
  113.     Multi-tasking 
  114.     
  115.     Use realtime.library, allowing a real pause when playing 
  116.     
  117.     Looping modes, using two locators 
  118.     
  119.     AppWindow and AppMenuItem 
  120.     
  121.     Localisation 
  122.     
  123.     Online Help and Menu Help 
  124.     
  125.                                      Registration
  126.  
  127.     Legal Informations
  128.     
  129.     Euterpe is Copyright © 1992-1997, Dominique Lorre 
  130.     
  131.     This product is distributed as SHAREWARE. 
  132.     
  133.     This software is limited in its functionalities (limitations detail vary
  134.     between software versions) and will only be fully operational by the add
  135.     of a key file. 
  136.     
  137.     This file can be obtained by registration. 
  138.     
  139.     You are authorised to distribute this software in its original form,
  140.     included on networks and on magazines disks or CD-ROM without 
  141.     restriction. The distribution by any mean of the keyfile is prohibited. 
  142.     
  143.     To obtain your personal keyfile, you can send 200 French Francs or 40 US
  144.     Dollars to : 
  145.     
  146.     Dominique Lorre 
  147.     Le Fabary, BAT C 
  148.     4, Allée des Peupliers 
  149.     13100 Aix-en-Provence FRANCE 
  150.     
  151.     Are accepted : International Postal Mandat, Eurocheques (in French
  152.     Francs) or for the France (Cheque or Postal Mandat). Cash paiement are
  153.     possible but at your own risk. 
  154.     
  155.     To obtain the keyfile, you will have to indicate either your email address 
  156.     where it will be sent uuencoded or join to your letter a formatted disk
  157.     which will be sent back to you with the last version of the software :
  158.     Never forget to indicate your address. 
  159.     
  160.     Delays are four weeks starting with the reception of your command (may be 
  161.     shorter, since sendings will be buffered). 
  162.     
  163.                                      Localisation
  164.  
  165.     Euterpe contains more than 700 lines to translate
  166.     
  167.     
  168.     To make a new catalog for Euterpe you can follow the following method: 
  169.     
  170.     Ask me before. May be somebody else has started the job and your work
  171.     will be fruitless. In the other hand, you could work together. 
  172.     
  173.     Look closely at the files Euterpe.cd and Euterpe_français.ct which are 
  174.     join with Euterpe's distribution. These are CatComp's files and you should 
  175.     be used with this utility before going on. 
  176.     
  177.     Euterpe is particular from the other software because the CatComp files
  178.     are automatically generated by a special version of the executable file.
  179.     Practically this mean that non translated texts will appear in the ct
  180.     file at each new version of Euterpe. 
  181.     
  182.     The name of the messages is globally politically correct ;) : 
  183.     All begin by MSG_ 
  184.     _MENU indicates a menu title 
  185.     _REQ indicates a requester message 
  186.     _GAD indicates a gadget label, '_' character is for underlining 
  187.     _ERR is for an error message 
  188.     _FMT is for sprintf formatted strings. Arguments order can not be
  189.     specified for now, since there are some floating point formats inside
  190.     these strings. 
  191.     
  192.     
  193.                                    History
  194.  
  195.     Once upon a time, nine muses, among which, Euterpe, was inspirating 
  196.     musicians...
  197.     
  198.     Between 1990 and 1991, I have been involved in the development of the 
  199.     Xanadu ADC16, a 16 bits audio board. This development gave me a lot of
  200.     ideas concerning the realization of a musical software for the Amiga. 
  201.     
  202.     The development of Euterpe has started in late 1992. At the beginning it
  203.     was on a few routines using the MIDI interface. But the software grew
  204.     bigger and more complex and the recording and playing functions where
  205.     achieved rapidly. 
  206.     
  207.     The general idea of the sequencer came a few time after : it had to be
  208.     simple to use. At the time of the WYSIWYG which made simpler the word
  209.     processors, I wanted an easily accessible sequencer.  Instead of
  210.     following the example of the available sequencers available (which were
  211.     powerful but quite complex), I had a closer look at some software such as
  212.     Superbase or Professional Page which contained a lot of ergonomic
  213.     features. 
  214.     
  215.     Most of the musical software are made for studio professionals but only a
  216.     few are giving interest to bands and their specifical needs in live or in 
  217.     practicing their songs. From this came the idea of the Pictures and Texts
  218.     instruments. It makes it possible to a band to display a song structure
  219.     or lyrics while practicing. In a live performance the sequencer can
  220.     display pictures illustrating the songs and can be remotely controled,
  221.     not with a MIDI keyboard but with a little hardware extension such as a
  222.     three button mouse. 
  223.     
  224.     Then came the time where Euterpe became hard to maintain for a single
  225.     person : the software was formed of more than 50 C language modules. It
  226.     was too much ! But the solution came with C++ which cut the source size
  227.     in two. The transition was easy and increased the adaptability of my code. 
  228.     
  229.     In 1994 the software was quite elaborated when the Commodore bad news
  230.     came. I recognize it makes me feel that I should found a publisher
  231.     quickly but I have not been successful, for the main reason that the
  232.     software had not been yet tested seriously. 
  233.     
  234.     In 1995, after a great testing campaign, the software was quite achieved
  235.     and ready to be published. I was talking of this with one of my friends (a 
  236.     singer) which told me about the interest of audio tracks in composition :
  237.     the lyrics could be moved in differents parts. I found the idea
  238.     intersting and started the modifications the next day... 
  239.     
  240.     After having completed the demolition of the software, I have rebuilded it 
  241.     on new bases, more clean and more adaptable. It was quite ready in 1996
  242.     when I finally decided to support AHI (who will complain). So we are now
  243.     in 1997 and now I think that great enhancements can be added to the code
  244.     without damages to the rest of the internal routines. 
  245.     
  246.     In the futur, I want to enhance continously my software, to make the 
  247.     direct-to-disk available and also provide note edition, add effects,
  248.     finish the metronome and some other features. For this, I need your
  249.     remarks, your encouragements and your registration. 
  250.     
  251.     
  252.                                     Thanks
  253.  
  254.     Here are those who helped me in the development of Euterpe
  255.     
  256.     Rob Peck, for his audiotools routines 
  257.     
  258.     Christian Braut, for his great Midi Book (Livre d'Or de la Norme Midi) 
  259.     
  260.     Martin Blom for AHI 
  261.     
  262.     Jérôme de Solliers, a good Beta-Tester 
  263.     
  264.     Nelson Barata, for his tests 
  265.     
  266.     Olaf Olsen Barthel, for his ratio calculation routine in GhostScript, the
  267.     only one which made what I wanted to. 
  268.     
  269.     Tallin, for CAMD.library 
  270.     
  271.     Tony Racine, from HiSoft, for his trust at a time where the software was
  272.     very unstable 
  273.     
  274.     Douglas Walker, from SAS, to have continuously enhanced his compiler 
  275.     
  276.     Amiga News and Amiga Concept magazines, for moral support 
  277.     
  278.     Antoine Grimaldi, for his SMPTE synchro box 
  279.     
  280.     If you are in this list, just contact me to obtain a free registration. 
  281.     
  282.                                         Author
  283.  
  284.     My coordinates
  285.     
  286.     
  287.     Dominique Lorre 
  288.     Le Fabary, BAT C 
  289.     4, Allée des Peupliers 
  290.     13100, Aix-en-Provence FRANCE 
  291.     
  292.                                        Versions
  293.  
  294.     Modifications bringed to the software
  295.     
  296.     
  297.     
  298.     
  299.     Version 1.10 -- first public version 
  300.     
  301.     Version 1.10 (7.08.97) 
  302.     Minor correction mineure bringed to ToolTypes parsing : the default size
  303.     of the fonts was 8 instead of the Preferences size. 
  304.     New Installer script. The previous one was creating a path entry for 
  305.     Euterpe instead of an Assign in the S:User-Startup file. 
  306.     Changes in the tooltypes of icon Euterpe.info, previous ones were coming 
  307.     from a non standard test configuration. 
  308.     New english guide file. 
  309.     
  310.     Version 1.11 
  311.     Modify Sample did not work 
  312.     PROGRAM CHANGE event was too long 
  313.     TEMPO CHANGE event was missing a byte. 
  314.     SYSEX REALTIME and NON REALTIME has been added 
  315.     MultiChannel samples implemented 
  316.     Add the options GERMAN, ENGLISH et LATIN for the notes display 
  317.     New option LIKEWB for a Like Workbench display 
  318.     Adjusted length in dialog boxes (and other cosmetic changes) 
  319.     System was crashing on exit after the creation of CAMD links 
  320.     Pictures instrument was not loaded correctly 
  321.     Texts instrument could not be saved 
  322.     Duration modification in the events window did not function on a block
  323.     larger than the list entries. 
  324.     Audio and Audio Drum instruments were not functionning correctly if some
  325.     sounds were not assigned. 
  326.     Loading and Saving of samples. 
  327.     Options saving 
  328.     Instruments can now be used with Metronome 
  329.     
  330.     Version 1.12 
  331.     Expand Track function now set the pattern output channel on the new track
  332.     if the original track was in Omni mode (useful for Midifiles type 0). 
  333.     Drum and Midi instruments were using the global Midi output instead of 
  334.     their own output. 
  335.     Midifiles import was not handling correctly some MetaEvents and was not
  336.     handling some Midi datas on the first track of Midifiles type 1. 
  337.     Samples default note is now C3 instead of C2 for trackers compatibility. 
  338.     Tempo gadget is now ranging from 20 to 400 bpm (max theoretical limit is 
  339.     72000/resolution bpm). 
  340.     Tempo changes are no more moved to the beginning of their measure. 
  341.     Protracker/NoiseTracker files import. 
  342.     Support for Pitchbend, KeyPressure, ChannelPressure and ControlChange 10
  343.     (Pan) for audio instruments. 
  344.     Effects support for patterns, tracks and song. 
  345.     Metronome was not functionning correctly if tempo was not 120bpm. 
  346.     Wave forms of a length greater than 65536 samples per channel are now
  347.     loaded from disk. 
  348.     Stereo samples are now supported. 
  349.     XApp instrument has been removed. 
  350.     Text documentation for those not having AmigaGuide V40. 
  351.     audio.device support removed. 
  352.     The ARexx command LOAD has been replaced by LOAD
  353.     SONG|PATTERN|TRACK|INSTRUMENT|SOUND (Only LOAD SOUND and LOAD SONG are
  354.     actually working). 
  355.     Samples file format has been modified. 
  356.     
  357.     Euterpe now uses the asyncio.library which is required for functionning. 
  358.     
  359.                                        Tutorial
  360.  
  361.     These pages will allow you to learn how to use Euterpe. Every
  362.     functionalities and methods are not presented here but only the more used. 
  363.     
  364.      Installation                        
  365.      Using Euterpe on System 2.0         
  366.      The Midi Files                      
  367.      The GM/GS/XG formats                
  368.     
  369.      Options                             
  370.      Create a track                      
  371.      Create a pattern                    
  372.      Create a Standard Midi File         
  373.     
  374.      MIDI Recording                      
  375.      MuliTracks Recording                
  376.     
  377.      Instruments                         
  378.      Midi (CAMD and serial.device)       
  379.      Audio (AHI)                         
  380.                             Euterpe's Installation
  381.  
  382.     What you need to know before installing Euterpe
  383.     
  384.     The software installation is simply taken in charge by Installer 
  385.     
  386.     A standard 3.0 system is enough for Euterpe's operation. If you want to
  387.     use Euterpe on a 2.0 system you should consult the installation
  388.     specificities. 
  389.     
  390.     Installation of CAMD.library is not provided by the software because I do
  391.     not actually have the license for distributing this library. Owner of the
  392.     Developer CD from Amiga Technologies or Electronics Arts Deluxe Music 
  393.     will found this library or have it already installed on their system. You
  394.     can also download the camd.lha archive from Aminet. Euterpe will
  395.     automatically detect the presence of the CAMD and will then provide you
  396.     access to its features. The 2.0 version of the CAMD.library is required
  397.     because the 1.0 is obsolete. 
  398.     
  399.     AHI should also be installed externally. The minimum version required is 4 
  400.     and you should not try it with Euterpe if you have a previous version
  401.     installed. 
  402.     
  403.     If you do not own the CAMD.library or AHI, Euterpe will continue to
  404.     operate normally, but will disable some specifics features. 
  405.     
  406.     Please note also that the online help will only function with an
  407.     AmigaGuide version >= 39. Beta-testing has proven that some users have
  408.     mistakenly installed some previous versions of this library. 
  409.     
  410.                          Euterpe Installation on a 2.0 system
  411.  
  412.     For the users of the V37 and V38 of the operating system
  413.     
  414.     Euterpe will not function with a standard V37 or V38 system. 
  415.     
  416.     Since Euterpe makes use of the realtime.library, you will need the special 
  417.     version of this file for the 2.0. Actually I do not have the license
  418.     rights which will allow me to distribute this file with the software.
  419.     Owners of Amiga Technologies Developer CD will find this file in the CD. 
  420.     
  421.     With a 2.0 system the online help has been disabled. 
  422.     
  423.     Some minor troubles may appear in the display. Please note that a 4 colour 
  424.     screen has been allowed only because of the Productivity ECS screen mode,
  425.     in fact the correct display will need at least 8 colors. 
  426.     
  427.     With a V37 system the locale.library is missing so the only language 
  428.     available will be english. 
  429.     
  430.     This software is regularly tested on an Amiga 600 V38+ECS. Note however
  431.     that most of the tests are done with a 3.0 system, so a few problems 
  432.     might be unknown of me. 
  433.     
  434.                                     The Midi Files
  435.  
  436.     The Midi Files are very important in the exchange of MIDI datas between 
  437.     different kinds of hardware and software. 
  438.     
  439.     
  440.     The Standard MidiFile (SMF) allows the transfer of datas between
  441.     different types of sequencers. 
  442.     Three formats already exist : 
  443.     
  444.     The format 0 is single track : every datas are on a single track. 
  445.     
  446.     The format 1 is multi tracks : one track is dedicated to a channel and a
  447.     supplementary track is created to manage the Tempo changes. 
  448.     
  449.     The format 2 is multi patterns : not recognised by Euterpe.                             The GM/GS/XG formats
  450.  
  451.     The GM, GS and XG formats allow the recognition of sounds and instruments 
  452.     employed for a music part.
  453.     
  454.     
  455.     The General MIDI (GM), the Roland GS and the Yamaha XG formats define a
  456.     standard for the sounds used by a synthetiser and notes for a drum kit. 
  457.     The GS format is an extension of the GM format from the manufacturer
  458.     Roland. The XG format is an extension of the GM format from the
  459.     manufacturer Yamaha, not yet recognized by Euterpe but you can still
  460.     create instruments for your XG banks. 
  461.     
  462.     Euterpe knows about the GM/GS formats and allows you to know which 
  463.     instruments had been employed. Further more, with the help of the Drum 
  464.     instrument you can also determine which DrumKit elements had been used.                               Euterpe's options
  465.  
  466.     Euterpe does not use an option file or environment variables, but use the
  467.     icons tooltypes and the command line parameters if started from CLI. 
  468.     
  469.     The command line template is the following : 
  470.     
  471.     F=FILES/M,ID=DISPLAYID/K/N,W=WIDTH/K/N,H=HEIGHT/K/N, 
  472.     D=DEPTH/K/N,AUTOSCROLL/S,OVERSCAN/S,R=RESOLUTION/K/N, 
  473.     RSTATUS/S,U=UNDOSIZE/K/N,G=GRID/S,SOFTTHRU/S, LANG=LANGUAGE=/K, 
  474.     TF=TEXTFONTNAME/K,TFS=TEXTFONTSIZE/K/N, 
  475.     SF=SCREENFONTNAME/K,SFS=SCREENFONTSIZE/K/N, 
  476.     SN=SERIALNAME/K,SU=SERIALUNIT/K/N, 
  477.     IL=INPUTLINK/K,OL=OUTPUTLINK/K,USECAMD/S,USEAHI/S, 
  478.     AHICHANS/K/N,AHISOUNDS/K/N, 
  479.     LATIN/S,GERMAN/S,ENGLISH/S,LIKEWB/S,ENCAPSULATED/S 
  480.     
  481.     /M means multiples 
  482.     /S means switch (True if set, False if not) 
  483.     /K means KeyWord 
  484.     /N means number 
  485.     = indicates a synonym. The short name cannot be used by the tooltypes. 
  486.     
  487.     
  488.     With the tooltypes, tou specify the option name, followed by = and the 
  489.     contents. 
  490.     Numbers are only decimal, Booleans are TRUE for true and FALSE for false. 
  491.     Actually all are false if not specified. 
  492.     
  493.     FILES
  494.     
  495.     With the CLI you can enter one or more filenames which will be loaded at 
  496.     program start. 
  497.     
  498.     ID
  499.     
  500.     Indicates the screen display mode. Actually, only a decimal number is
  501.     accepted. Hexadecimal numbers can be converted with the CLI command Eval : 
  502.     
  503.     Eval 0x8000 
  504.     32768 
  505.     
  506.     and the contrary : 
  507.     
  508.     Eval 32768 LFORMAT "%X8*N" 
  509.     00008000 
  510.     
  511.     WIDTH
  512.     
  513.     Indicates the screens width. If the specified width is lesser than 640
  514.     pixels it will be automatically set to this value (640). 
  515.     
  516.     HEIGHT
  517.     
  518.     Indicates the screens height. If the specified height is lesser than 200
  519.     pixels it will be automatically set to this value (200). 
  520.     
  521.     DEPTH
  522.     
  523.     Indicates the screens depth. If the specified depth is lesser than 2
  524.     pixels it will be automatically set to this value (2). You can calculate
  525.     the number of colors with by elevating 2 to the power indicated by depth. 
  526.     
  527.     DEPTH=2 gives 4 colors, 3 gives 8 colors, 4 gives 16 colors and so on. 
  528.     
  529.     AUTOSCROLL
  530.     
  531.     Activate automatic scrolling of screens. 
  532.     
  533.     OVERSCAN
  534.     
  535.     Activates the overscan mode for screens. 
  536.     
  537.     RESOLUTION
  538.     
  539.     Internal sequencer resolution in pulses per quarter note. This value is
  540.     not actually limited. Anyway the options dialog box will propose you
  541.     reasonnable values between 96 and 768 (192 is the default) 
  542.     
  543.     RSTATUS
  544.     
  545.     Activate Running Status mode in MIDI flows 
  546.     
  547.     This option is not actually working 
  548.     
  549.     UNDOSIZE
  550.     
  551.     Undo/Redo buffer size 
  552.     
  553.     This option is not actually working 
  554.     
  555.     GRID
  556.     
  557.     Activates the grid. With the grid patterns are placed at the beginning of
  558.     the measure. 
  559.     
  560.     SOFTTHRU
  561.     
  562.     SOFTTHRU mode allows you to read midi events and to send them back even
  563.     when the sequencer is not recording. 
  564.     
  565.     LANGUAGE
  566.     
  567.     Indicates the language to use. 
  568.     
  569.     TEXTFONTNAME
  570.     
  571.     Name of the fixed size font. Beware of the case differences : Topaz.font
  572.     will give a different result of topaz.font 
  573.     
  574.     TEXTFONTSIZE
  575.     
  576.     Taille de la fonte non proportionnelle. Size of the fixed-size font. 
  577.     
  578.     SCREENFONTNAME
  579.     
  580.     Name of the proportional font. 
  581.     
  582.     SCREENFONTSIZE
  583.     
  584.     Size of the proportional font. 
  585.     
  586.     SERIALNAME
  587.     
  588.     Name of the serial driver (example: serial.device) 
  589.     
  590.     SERIALUNIT
  591.     
  592.     Unit number of the serial device 
  593.     
  594.     INPUTLINK
  595.     
  596.     Name of the CAMD input link. 
  597.     
  598.     OUTPUTLINK
  599.     
  600.     Name of the CAMD output link. 
  601.     
  602.     USECAMD
  603.     
  604.     Use the CAMD functions. 
  605.     
  606.     USEAHI
  607.     
  608.     use the AHI functions. 
  609.     
  610.     AHICHANS
  611.     
  612.     AHI channels number 
  613.     
  614.     AHISOUNDS
  615.     
  616.     AHI sounds number 
  617.     
  618.     LATIN
  619.     
  620.     Latin Notation (Do Ré Mi Fa Sol La Si) 
  621.     
  622.     GERMAN
  623.     
  624.     German Notation (C D E F G A H) 
  625.     
  626.     ENGLISH
  627.     
  628.     English Notation (C D E F G A B) 
  629.     
  630.     LIKEWB
  631.     
  632.     Use Workbench settings for the display 
  633.     
  634.     ENCAPSULATED
  635.     
  636.     Not used for the moment. 
  637.     
  638.     Examples
  639.     
  640.     If you want to use AHI and a screen depth of 5 (32 colors) from the CLI 
  641.     
  642.     Euterpe:Euterpe USEAHI DEPTH=5 
  643.     
  644.     and with ToolTypes : 
  645.     USEAHI=TRUE 
  646.     DEPTH=5 
  647.     
  648.     Workbench start
  649.     
  650.     If you start Euterpe by selecting one or more icons, the options will be 
  651.     those of the first selected icon. 
  652.     
  653.     Preferences saving will only modify Euterpe:Euterpe icon. Anyway, each
  654.     time you save a file, the actual preferences are stored to its icon. So,
  655.     you can create songs without events, only for keeping different
  656.     configurations. 
  657.     
  658.                                     Create a track
  659.  
  660.     Each project constructed with Euterpe is formed of tracks and patterns. A
  661.     track is the vertical part of a project and is useful in the repartition 
  662.     of the MIDI Channels. The right part is dedicated to the patterns.
  663.     
  664.     To create a track, two methods are possible : 
  665.     
  666.     With the mouse, by double clicking in the edition window. 
  667.     
  668.     In the EMusic window with the command : 
  669.     CREATE TRACK "TrackName"where TrackName is the selected name for the
  670.     track.                               Create a pattern
  671.  
  672.     A pattern is the horizontal part of a project and its main purpose is in
  673.     managing instruments and events. The patterns are located on the right
  674.     part of the screen. The left part is dedicated to the tracks.
  675.     
  676.     To create a pattern; three methods are allowed : 
  677.     
  678.     With the mouse, by double clicking in the edition window in the front of 
  679.     the selected track. 
  680.     
  681.     With the duplicate option in the Patterns menu. A copy of the current
  682.     pattern will be made. 
  683.     
  684.     In the EMusic window, with the command : 
  685.     CREATE PATTERN "PatName"where PatName is the selected name for the
  686.     pattern. The pattern will be created on the current track.                              Create a Midi File
  687.  
  688.     By creating a Midi File, you will be able to transfer your projects to 
  689.     other sites not yet equiped with Euterpe.
  690.     
  691.     To create a Midi File, you must have a project loaded in RAM then select
  692.     the Export option from the Project menu and the sub-entry MIDIFILE 0 ou
  693.     MIDIFILE 1 depending on the selected type.                                MIDI Recording
  694.  
  695.     The MIDI recording is one of the main functions of a sequencer. Before
  696.     anything else you must have a MIDI source (such as a keyboard with a MIDI
  697.     OUT plug), a midi interface for your computer, and at least a cable to
  698.     make the junction between the MIDI OUT plug of your source and the MIDI
  699.     IN plug of your interface. 
  700.     
  701.     The simplest method for recording is to create a pattern, activating it 
  702.     it if necessary with a mouse click. Then select the record button in the
  703.     Control window. When you will push the Play button, you will then notice
  704.     that the position counters has started moving. To stop the recording,
  705.     simply push the Stop button.                            Multitracks recording
  706.  
  707.     Multitracks recording allows the recording of more than one MIDI channel 
  708.     at the same time. 
  709.     
  710.     For multitrack recording, you have to select the Record option and the 
  711.     input channel in the track Edit window for each desired track. Other 
  712.     channels will be filtered.                        Midi (CAMD and serial.device)
  713.  
  714.     MIDI stands for Musical Instrument Digital Interface and its 
  715.     specifications tell how the datas are travelling between a network of 
  716.     machines composing a network. 
  717.     
  718.     On the Amiga, this datas are generally using the serial interface and 
  719.     need a MIDI interface or a serial cable for linking two Amigas. This is
  720.     what Euterpe was using in the first time. 
  721.     
  722.     The actual version allow you to access as many Midi networks as you have 
  723.     serial ports and you can also open virtual Midi accesses on other CAMD 
  724.     applications. 
  725.     
  726.     This Midi accesses are defined as input and output and defined by a name 
  727.     (e.g. : serial.device) and a unit number (0 is default unit). The same 
  728.     access or a different access can be used in input and output. The
  729.     accesses are used by Midi and Drum instruments and can be edited by the
  730.     menu Edit -> Midi Access. You will notice a list with a selected entry : 
  731.     the access which is selected is the default one, used for the edition and
  732.     other operations (such as Midi Testing) where Instruments are not taken
  733.     into account. 
  734.     
  735.     The use of the CAMD.library will allow you to create internal accesses to
  736.     transmit MIDI datas to other CAMD software or to CAMD Midi drivers. For
  737.     example, you can create a Midi access (called Cluster) that will be used 
  738.     as an output for Euterpe and as an input for another CAMD software (such
  739.     as a MIDI effect processor) which will then transform the datas and send
  740.     them to the MIDI interface or to another software. 
  741.     
  742.                                      Audio (AHI)
  743.  
  744.     Audio with Euterpe is functionning in two ways : like a Midi instrument 
  745.     or as a single sample. 
  746.     
  747.     Euterpe being dedicated to become a full-featured software, the Audio
  748.     routines constitute a big part of the application. 
  749.     
  750.     in the first time, this routines were based on audiotools routines of Rob
  751.     Peck, which may be a little old but are still the best way to use the
  752.     audio.device. 
  753.     
  754.     Historically, these routines are tied to the IFF 8SVX and IFF SMUS file 
  755.     formats. The samples are defining octaves and an array say which octave
  756.     must be used for each of the 128 Midi notes. These samples also have an
  757.     introduction part played once and a repeat part, played again until the
  758.     end of the note. 
  759.     
  760.     This mecanism has been greatly enhanced by the introduction of the
  761.     Dissidents's SAMP format which brings the possibility of using 
  762.     resolutions from 8 to 32 bits, a varying number of channels (IFF 8SVX
  763.     format is at most stereophonic) and do not define octaves anymore but a
  764.     set of waves for each of the 128 notes. This great format did not
  765.     encounter much success, probably because of it's complexity and also
  766.     because some fields are missing to make it really perfect (For example, a
  767.     435 Hz A can not be differenciated from a 440 Hz A because the note is
  768.     defined as a Midi index). Euterpe is however internally very close to the
  769.     SAMP format. 
  770.     
  771.     Actually, Euterpe is able of reading the following formats : IFF 8SVX and
  772.     IFF AIFF. Other formats can be imported with the DataTypes (3.0 or +
  773.     needed), in this case they will be converted to IFF 8SVX (8 bits). 
  774.     
  775.     The new AHI system is a great enhancement concerning the number of audio 
  776.     channels and the sounds resolution. It's major advantage is the
  777.     possibility to interface transparently not only the Amiga internal audio
  778.     but also most of the sound cards available on the market. With AHI, it is
  779.     now possible to define a new audio format. 
  780.     
  781.     audio.device support has been removed because of the difficulty of
  782.     implementing the double-buffered reading and also because of the
  783.     impossibility of setting volume, frequency and panoramics without
  784.     accessing the hardware. Since the AHI support routines have been greatly
  785.     enhanced, the loss of quality of some 8 bits samples will be certainly be
  786.     solved by a better selection of your audio driver. 
  787.     
  788.     If you use AHI, then it will be possible to configure more than one Audio 
  789.     output with the menu Edit -> Audio Access. The default access will be the
  790.     one selected in the list. 
  791.     
  792.     Some sampling routines are included in Euterpe. Since they do not provide
  793.     good results for now, you should avoid the recording on audio track for
  794.     now. 
  795.     
  796.     
  797.                             Questions and Answers
  798.  
  799.     Since you may ask some questions about this software, here are some
  800.     answers. 
  801.     
  802.     How to set the locators ?
  803.     Go to the wanted position and then simply click on the record button.
  804.     Select then the locator you want to set. 
  805.     
  806.     What is external control ?
  807.     Theses controls are for those of you which want to bring their Amiga on
  808.     stage ! In this case a simple three buttons mouse connected on the
  809.     joystick port will allow you to control the functions of your needs. 
  810.     Those who have some electronic knowledge will be able to easily make some
  811.     kind of foot pedal. 
  812.     
  813.     What is navigation screen for ?
  814.     When a band starts a practice session, maybe one musician doesn't know the 
  815.     song structure or may be the singer forgot the texts ... Navigation
  816.     screen is here for introducing useful informations when the song is
  817.     performing (it sure can do karaoke but this is not my cup of tea). 
  818.     This can be also be useful on stage if you want to add some visual effects 
  819.     to your compositions... (notice that this screen is genlock aware) 
  820.     
  821.     What is OUI ?
  822.     OUI means Object User Interface. This is a collection of C++ functions
  823.     designed to make GUI programming easy. A simple dialog box is made with
  824.     OUI in less than fifty lines of code. OUI has nothing to see with UIK,
  825.     MUI or the others. It is even possible to interface OUI with any of
  826.     those... The (awful ;)) OUI gadgets are simply BOOPSI gadgets that I
  827.     wrote to enhance a little my interface. May be one day I will give OUI to
  828.     the public domain but it is not my priority. Tell me if you want things
  829.     speeded up. 
  830.     
  831.     
  832.                               Euterpe 's Screens
  833.  
  834.     You have probably noticed that Euterpe used two scrrens. One of them is
  835.     dedicated to the windows and the other one to the display. 
  836.     
  837.     The Public Screen
  838.     The main screen of Euterpe is a public and its name is Euterpe. If the
  839.     application is quitting and if windows that do not depend of the
  840.     application (known as visitor windows) are still there, Euterpe will ask
  841.     you to close them. If the windows are still present after that, Euterpe
  842.     will free everything but will let the screen opened. If later, you load
  843.     again Euterpe then the application will use this screen instead of
  844.     creating another one. 
  845.     
  846.     The Navigation Screen
  847.     The text display is made on a so called Navigation screen which is also 
  848.     used by external controls. If you select the Navigation screen active 
  849.     option this screen will pass in the foreground at each play and then to
  850.     the background at each stop. If the option inactive the screen will stay
  851.     in the background. 
  852.     
  853.     Other screens
  854.     If you are displaying pictures, Euterpe will load them in a separate 
  855.     screen. This one will be closed at the end of the display. If your 
  856.     pictures do not display, it is possible that there is not enough memory 
  857.     left for a new screen initialisation. 
  858.     
  859.                                   Euterpe's windows
  860.  
  861.     Euterpe's windows, associated with menus and gadgets are the main way to 
  862.     control the sequencer. Here are the most importants : 
  863.     
  864.     Tracks 
  865.         Edition of tracks and patterns. The tracks are drawn vertically. On
  866.     the left appear the name of the track. Are following the name of the
  867.     instrument, the input and output channels, the three buttons for Mute,
  868.     Record and Effects and on the left the sections. verticalement. 
  869.     Control 
  870.         TapeDeck like controls. From left to right : Record, Start, Begin,
  871.         Rewind, Forward, End, Stop, Pause, Left Locator, Right Locator, Solo,
  872.         Cycle, Punch In/Out, Time Sig selection In the second line are the
  873.         tempo and the different pointer positions (song and locators) 
  874.     Events 
  875.         The midi events edition window 
  876.     Bars 
  877.         The graphical note edition window. In the upper right is a lupe for
  878.         more precision. 
  879.     Track creation 
  880.         Name of the track, instrument choice, channels, kind (Audio or
  881.         Instrument) You will be able to access the Master Track only by the
  882.         menu Edit -> Master Track 
  883.     Patterns parameters 
  884.         Name of the pattern, initial position 
  885.     Instruments parameters 
  886.         Instrument name, instrument kind, Save, Load, Detailed edition 
  887.     Midi Instrument 
  888.         Name given to the program changes. Midi acess for input and output. 
  889.     Drum Instrument 
  890.         Note setting for each drum element 
  891.     Text Instrument 
  892.         Font choice, position setting, text definition 
  893.     AREXX instrument 
  894.         Choice and loading of the ARexx files 
  895.     Picture Instrument 
  896.         Images choice, loading and display of the pictures 
  897.     Audio Instrument 
  898.         Choice and edition of sounds. Choice of the audio access. Sounds are
  899.         set on program changes. 
  900.     Audio Drum Instrument 
  901.         Choice and edition of sounds. Choice of the audio access. Sounds are
  902.         set on notes. 
  903.     XAPP Instrument 
  904.         Choice of the Message Port 
  905.         
  906.                                 Euterpe Menus
  907.  
  908.     Euterpe dispatches its menus in different windows. 
  909.     
  910.      Project Menu           Windows Menu           Tracks Menu          
  911.      Patterns Menu          Edit Menu              Preference Menu      
  912.      Macros Menu            MIDI Control Menu    
  913.                                  Project Menu
  914.  
  915.     This menu holds the general functions of the software. 
  916.     
  917.     New 
  918.         Create a new file. 
  919.     Open 
  920.         Load a file. The file format is automatically recognised between the
  921.         following : 
  922.         - ETSF : Proprietary format (EuTerpe Sequencer File) 
  923.         - SMF  : Standard MidiFile type 0 ou 1 
  924.         - SMUS : IFF SMUS format 
  925.     Save 
  926.         Save a song in the ETSF Euterpe format 
  927.     Save as 
  928.         Rename a song 
  929.     Export 
  930.         allow the exportation in the following formats : 
  931.         MidiFile Type 0 : Mono track Midi File Format 
  932.         MidiFile Type 1 : Multi Track Midi File Format 
  933.     Quit 
  934.         End of the application and of the public screen Euterpe if no visitor
  935.         window is still present. Else the screen will stay open and will be
  936.         use in any next launching of Euterpe. 
  937.     Information 
  938.         Display the version number and your coordinates. 
  939.     Help 
  940.         Call AmigaGuide and display the Euterpe's help 
  941.     
  942.                                      Windows Menu
  943.  
  944.     This menu exists on all opened windows other than dialog box and allows 
  945.     you to make active or open the selected window. 
  946.     
  947.     Tracks 
  948.         The tracks and patterns edit window 
  949.     Control 
  950.         The tapedeck type controls 
  951.     EMusic Console 
  952.         Open the EMusic console for command line interfacing. 
  953.     Files 
  954.         Display the name of each song currently available and makes active
  955.     the one selected. 
  956.                                      Tracks Menu
  957.  
  958.     This menu holds the tracks control functions 
  959.     
  960.     Open 
  961.         Load a track 
  962.     Save 
  963.         Save a track 
  964.     Remove 
  965.         Remove the current track 
  966.     Duplicate 
  967.         Make a clone of the current track 
  968.     Erase 
  969.         Erase everything into the track 
  970.     Mix 
  971.         Mix the events of the selected tracks into a new one (multi-select is
  972.         SHIFT + left mouse button) 
  973.     Expand 
  974.         Each section is placed on a single track 
  975.     Play 
  976.         Play the track alone 
  977.     First Pattern 
  978.         Move the position pointer to the first pattern of the track 
  979.         
  980.                                         Patterns Menu
  981.  
  982.     This menu holds the patterns control functions 
  983.     
  984.     Open 
  985.         Loads a pattern 
  986.     Save 
  987.         Save the current pattern 
  988.     Remove 
  989.         Remove the current pattern from the track 
  990.     Edit 
  991.         Edit the current pattern 
  992.     Duplicate 
  993.         Makes one or more copies of the current pattern 
  994.     Erase 
  995.         Remove all the events from the current pattern 
  996.     Mix 
  997.         Mix two or more sections (multi-select is SHIFT + left mouse button) 
  998.     UnMix 
  999.         Create sections from the current one 
  1000.     Play 
  1001.         Play the current section 
  1002.     Quantify 
  1003.         Open the quantifying window 
  1004.     Effects 
  1005.         Open the effects window 
  1006.     Front 
  1007.         In case of many patterns at the same place, display the current
  1008.         section in front of the others 
  1009.     Back 
  1010.         In case of many patterns at the same place, display the current
  1011.         section in back of the others                                  Edit Menu
  1012.  
  1013.     This menu holds the edit functions. 
  1014.     
  1015.     Cut 
  1016.         Remove the selection and place it into the clipboard. 
  1017.     Copy 
  1018.         Place the selection into the clipboard 
  1019.     Paste 
  1020.         Insert the clipboard contents 
  1021.     Master Track 
  1022.         Allows you to edit various parameters such as tempi and time
  1023.         signatures changes 
  1024.     Midi Access 
  1025.         Allows you to edit access to the MIDI outputs via serial port or
  1026.         CAMD.library 
  1027.     Audio Access 
  1028.         Allows you to edit access to the audio outputs via internal routines
  1029.         or AHI functions 
  1030.     Samples 
  1031.         Samples editing 
  1032.     MidiMix 
  1033.         Fenêtre de mixage du volume et des panoramiques pour les 16 canaux
  1034.         Midi. 
  1035.     Undo 
  1036.         Cancel the last operation 
  1037.     Redo 
  1038.         Restore the last canceled operation                               Preferences Menu
  1039.  
  1040.     This menu contains the software configuration options 
  1041.     
  1042.     External controls 
  1043.         Edit the external controls for the current song 
  1044.     Workbench 
  1045.         Open/Close the Workbench 
  1046.     Display 
  1047.         Choose the screen mode 
  1048.     Navigation screen 
  1049.         Genlocks controls for the play screen 
  1050.     CLI 
  1051.         Launch a CLI process on Euterpe's screen 
  1052.     Options 
  1053.         Differents setting such as the grid and the resolution 
  1054.     Save 
  1055.         Save the options 
  1056.     Load 
  1057.         Load an option file                                  Macro Menu
  1058.  
  1059.     This menu hold the operations on macros. 
  1060.     
  1061.     Record 
  1062.         Record the application events into a macro 
  1063.     Edit 
  1064.         Select and edit a macro 
  1065.     Execute 
  1066.         Execute a macro 
  1067.     Open 
  1068.         Open a macro from disk 
  1069.     Save 
  1070.         Save a macro on disk 
  1071.     Function keys 
  1072.         Assign function keys to macros                              Midi Control Menu
  1073.  
  1074.     This menu contains the synchronisation, test and control MIDI functions 
  1075.     
  1076.     Omni On 
  1077.         Send an Omni On message on the active midi channel
  1078.     Omni Off 
  1079.         Send an Omni Off message on the active midi channel
  1080.     Mono On 
  1081.         Send an Mono On message on the active midi channel
  1082.     Poly On 
  1083.         Send an Poly On message on the active midi channel
  1084.     Program Change 
  1085.         Send an Program Change message on the active midi channel
  1086.         
  1087.         
  1088.     Song Selection 
  1089.         Send a Song Select message 
  1090.     Song Pointer Position 
  1091.         Send a Song Pointer Position message 
  1092.         
  1093.         
  1094.     Metronome 
  1095.         Metronome Settings 
  1096.     Input Clock 
  1097.         Select the clock type 
  1098.             Internal 
  1099.                 Amiga timer is used 
  1100.             LTC Audio Time Code 
  1101.                 Audio Informations from a sampler are used as time basis 
  1102.                 (SMPTE/LTC type) 
  1103.             Midi Time Code 
  1104.                 Use an external Midi Time Code 
  1105.             Midi Clock 
  1106.                 Midi Clocks are used as time basis 
  1107.             Aux Input 
  1108.                 Pulses from one of the two mouse/joystick ports are taken as
  1109.                 time basis 
  1110.     Output Clock 
  1111.         Select the kind of synchro for output 
  1112.             None 
  1113.                 No synchro is sent 
  1114.             Midi Time Code 
  1115.                 Midi Time Code 
  1116.             Midi Clocks 
  1117.                 Midi Time Clocks 
  1118.             LTC Audio Time Code 
  1119.                 Audio signal to record on a magnetophone 
  1120.                 
  1121.                 
  1122.     Midi Testing 
  1123.         Différents tests pour vérifier que votre configuration MIDI fonctionne 
  1124.             Notes On/Off 
  1125.                 Envoie des notes sur les différents canaux midi 
  1126.             Program Changes 
  1127.                 Send program changes on the differents midi channels 
  1128.             Bank Select 
  1129.                 Send BANK SELECT messages on the differents midi channels 
  1130.                 
  1131.                                                ARexx functions
  1132.  
  1133.     The ARexx port is entitled Euterpe. Do not mistake the use of ARexx with
  1134.     the capability of defining an ARexx instrument which will execute ARexx
  1135.     scripts during the play. Some of these functions are available under
  1136.     external control. 
  1137.     NEW 
  1138.         Create a new project 
  1139.     LOAD "NomFic" 
  1140.         Load a file 
  1141.     SAVE 
  1142.         Save 
  1143.     SAVE AS 
  1144.         Sauver as 
  1145.     QUIT 
  1146.         Quit Euterpe 
  1147.     CREATE TRACK "TrackName" 
  1148.         Create the track TrackName 
  1149.     CREATE PATTERN "PatName" 
  1150.         Create the pattern PatName on active track 
  1151.     LOCATION 
  1152.         Tell the actual position 
  1153.     LOCATION "mmm:tt:ppp" 
  1154.         Set the position at mmm:tt:ppp. 
  1155.     PRINT expr 
  1156.         Display the result of expression expr 
  1157.     OUT val,val... 
  1158.         Send datas to the MIDI OUT plug 
  1159.     ID = val 
  1160.         Define the identifier id with value val 
  1161.     START 
  1162.         Start the play 
  1163.     STOP 
  1164.         Stop 
  1165.     RECORD 
  1166.         Record set to the active state 
  1167.     STARTSTOP 
  1168.         Stop if play, start if stopped. 
  1169.     ED "FileName" 
  1170.         Edit the file FileName (Actually uses C:Ed or the editor defined by
  1171.         the EDITOR environment variable). 
  1172.         
  1173.                                     The keyboard shortcuts
  1174.  
  1175.     Here are the Euterpe functions that you can access with the keyboard.    
  1176.     In the tracks window or in the navigation screen, press on the     space
  1177.     bar for the Start/Stop function. 
  1178.     
  1179.         In the tracks window, B allow the edition of the selected pattern    
  1180.     with Bars and E with Events. Please note that a side effect will allow   
  1181.      you to edit the samples with Events or Bars. This is harmless but also  
  1182.       useless. 
  1183.     
  1184.         In the track window, the cursor keys up and down will allow you    
  1185.     to change the selected track and left and right are for the pattern    
  1186.     changes. 
  1187.     
  1188.                                 Euterpe's instruments
  1189.  
  1190.     Euterpe offer you a big instruments palette. Eight instrument types are 
  1191.     defined. Each instrument track use only one instrument but one instrument 
  1192.     can be used by more than one track. 
  1193.     
  1194.     Instruments are : 
  1195.     MIDI 
  1196.     MIDI instrument is the one by default. The notes are send to the Midi
  1197.     output. This instrument use the General MIDI/Roland GS definitions for
  1198.     the program changes but you can modify these.0 
  1199.     DRUM 
  1200.     DRUM instrument is like MIDI but is specially adapted to rythm machines.
  1201.     The drum notes of the GM/GS format are used but you can modify those to
  1202.     your configuration and also make notes conversion. 
  1203.     AUDIO 
  1204.     AUDIO instrument is very like the MIDI one except that it use up to 128
  1205.     audio sounds which are controlled by Program Changes. 
  1206.     AUDIO DRUM 
  1207.     AUDIO DRUM instrument is very like the DRUM one except that it use up to
  1208.     128 audio sounds which are mapped to the Midi notes. 
  1209.     TEXTS 
  1210.     Up to 128 text strings are definable with a font and a position for each
  1211.     of this texts. These strings are mapped to the Midi Notes. 
  1212.     Pictures 
  1213.     Up to 128 IFF ILBM pictures can be selected and mapped to the 128 MIDI
  1214.     notes. DataTypes are used if available. 
  1215.     AREXX 
  1216.     AREXX instrument allow to assign up to 128 ARexx scripts to the Midi
  1217.     notes. 
  1218.     XAPP 
  1219.     With XAPP inst you have a link to the outside world. Notes will be sent 
  1220.     via a MsgPort. For more information you should look at the XAppDemo
  1221.     example program.                             Active MIDI channel
  1222.  
  1223.     The active MIDI channel is the channel of the selected track, or if no
  1224.     track has been selected this channel do not exist. If the selected track
  1225.     has been put in Omni mode then the MIDI active channel will be the MIDI
  1226.     channel of the first selected pattern.
  1227.     ARexx            Keyboard         Euterpe          Menus        
  1228.     Instruments  
  1229.